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Preface 



Prerequisite documents 
Companion documents 



This document introduces the electronic mail and message facilities available on 
the Sun workstation. We assume that you have some experience with the Sun 
workstation, and the UNIXf operating system. 

We provide examples to learn how to send, read, and reply to mail and messages, 
not detailed explanations of the inner workings of the mail and message pro- 
grams. However, as in each of the Beginner’s Guides, we refer to the other Sun 
documentation, drawing a road map for you to follow when you wish to learn 
more about a certain topic. 

Mail and Messages describes how to send, read, store, reply to, and forward mail 
using the mail program. It introduces mailtool, a window and mouse mail 
program. In addition, this manual presents the various message programs and 
describes how mail travels over various networks. A command summary and a 
glossary provide easy access to the material. 

Getting Started With UNIX: Beginner’s Guide 

Setting Up Your UNIX Environment: Beginner’s Guide 
Windows and Window-Based Tools : Beginner’s Guide 
Self Help With Problems: Beginner s Guide 
Doing More With UNIX: Beginner’s Guide 
Using the Network: Beginner’s Guide 

Commands Reference Manual 



t UNIX is a trademark of AT&T Bell Laboratories. 
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Overview 



Note: A network is a group of 
machines connected so they can 
transmit information to one another. 
A local network is the network sur- 
rounding your machine; whereas, a 
remote network is a network that 
doesn’t include directly your 
machine. Networks link with each 
other using a gateway. 



Electronic mail and electronic messages ease communication in the workplace. 
Many people find it useful to send and receive electronic mail and messages 
through a computer network, especially when it is impossible or inconvenient to 
communicate in person, by phone, or by post office mail. 

Sending electronic mail is like sending a telegram. You can read, save, and edit 
electronic mail when you receive it on your machine. 

Initiating an electronic message is more like calling someone up on the phone 
than sending a telegram, because it is immediate and interactive. In other words, 
when you send an electronic message, the person who receives the message can 
read the message and reply to it while you wait. You can have an asynchronous 
electronic conversation, in other words, both parties sending and receiving mes- 
sages simultaneously through the computer network without their messages 
interfering with one another. 



1.1. What Is mail? mail is the program you can use to send electronic mail. 1 

There are three types of electronic mail addresses, depending upon the destina- 
tion of the mail: 

same machine 

Specify only the username of the mail recipient. 
local network 

Specify the username, and in some cases the machine name, of the reci- 
pient 



Note: A network path is the 
sequence of machines you must 
specify to send mail between two 
machines when they are connected 
on a network that doesn’t determine 
the path automatically. 



remote network 

Specify the recipient’s username and machine name, and in some cases 
the network path to the recipient. 

An optional file in your home directory, called the .mailrc file, alters the 
default behavior of the mail program. 2 



1 Historically, the mail and Mail programs differed considerably, but now they are the same. You can 
type either mail or Ma i 1 when you see examples that specify mail. 

2 To find out more about . ma i 1 r c, see Setting Up Your UNtx Environment: Beginner's Guide. To change 
most mail attributes, use default sedit, described in the chapter on other editing tools in Windows and 
Window-Based Tools: Beginner’s Guide. 



Asun 

microsystems 




mailt ool is mail enhanced with window and mouse capability. If you use 
the window system, try mailtool to see if you like it better than mail. 3 

There are four types of electronic messages, which are immediate and interac- 
tive: 

same machine 

Use the write or talk program; specify username of recipient. 
local network 

Use the talk program; specify username, sometimes machine name, 
of recipient. 

broadcast 

Use the wall program; specify message text to send to all users on 
machine. 

system 

Messages the system sends to your console. 

When you want to stop display of write and talk messages to your console, 
add 

mesg n 

(n stands for no) on a line by itself in your . login file. 

When you put 

biff y 

on a line by itself in your . login file, the system displays mail message 
notifications on the console as mail messages arrive; by default, the system 
suppresses mail message notifications with biff n. 

For more information on mesg and biff, including an example . login 
file, see Setting Up Your UNIX Environment: Beginner’s Guide. 

13. Other Useful Commands A variety of other commands aid you in reading mail and sending messages. 

Further descriptions of these commands appear later in this manual. 

from Tells you who the mail in your system mailbox is from 

prmail Displays (with cat) the mail that you haven’t yet read using 

mail 

users Lists the username for each user currently logged in on the local 

machine 



3 For more information, see the chapter on mailtool, Chapter 6 . 



13. What Is an Electronic 
Message? 



Note: The console is the entire 
screen, or a special window on the 
screen, where system messages 
appear. 



it- sun 

\r microsystems 




Chapter 1 — Overview 5 



who Lists the username, “terminal,” and login time for each user 

currently logged in on the local machine 

w Lists the username, “terminal,” login time, and other statistics 

for each user currently logged in on the local machine 

rsh machine-name command 

Executes command on machine machine-name. Useful for list- 
ing usernames, and other information about people on other 
machines. 

This completes the overview of electronic mail, electronic messages, and related 
commands. 
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Sending Mail 



The easiest way to use mail is to send a mail message to someone, even your- 
self. In fact, start by sending a mail message to yourself, so you can make sure 
that you have the hang of it before subjecting someone else to your trials, and so 
that you will have a mail message you can read “in your mailbox.” 



2.1. Sending a Mail Message To send a mail message, type mail followed by the username of the recipient. 



Sending a Mail Message To To send a mail message to yourself, type mail followed by your username. 
Yourself Then, type the text of the message, on as many lines as you wish. Type your 

end-of-file character, usually I CTRL-D1 . on a line by itself to terminate input of 
the message text. 4 



Figure 2-1 Sending a Mail Message To Yourself 

venus % mail medic i 
Subject: Mail To Myself 

Introspection is a narcissistic pursuit . 

~D 

venus % 

s > 



mail changes the "Don the screen to EOT to confirm die end of text of your 
mail message. 



Sending a Mail Message to When you decide you are confident enough to try sending a message to another 

Someone Else user, type mail followed by the username, the message text, and [ CTRL-D1 . 

When you type I CTRL-D) . mail saves the text of the message and sends it to 
the destination username, provided it is within the local network. 5 



4 In this example, venus% is the command prompt because venus is the name of the example machine, 
medic i is the example username. 

5 When your machine isn’t on a network, you can’t send mail to users on other machines. Some facilities 
don’t support the yellow pages , a directory of usernames and machine names. If your facility doesn’t support 
the yellow pages, you have to specify the machine name along with the username of the mail message recipient 
See the section on sending mail messages over local networks, section 4.5 , for more information. Chapter 9 , 
on sending mail over networks, provides information on sending mail messages over remote networks. 
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Figure 2-2 Sending a Mail Message to Someone Else 




It takes a little while for the mail facility to deliver mail. However, if the 
intended mail recipient doesn’t receive the mail message you sent within a day, 
see the section on sending mail over networks, section 4.5 , to learn how to fix 
the problem. 6 

To specify multiple recipients for your mail message, type more than one user- 
name, each separated by a space character. 

Sending Mail to a Nonexistent If you send the mail message to a username that does not exist, mail will real- 
Usemame ize, after a minute or two, that it cannot deliver the mail message. 

For example, if you send mail to nonexistent username amorphous, like this: 
Figure 2-3 Sending a Mail Message to a Nonexistent Username 




At this point, three things happen: 

1) The mail facility displays an error message containing the nonexistent user- 
name, followed by three dots (...) and User unknown. In the case of 
the above example, the error message is: 

amorphous . . . User unknown 



Note: Username watson probably 
doesn’t exist on your machine or 
local network. The next section 
describes the result of sending mail 
to a nonexistent username. 
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2) The mail facility delivers a mail message to you, the originator of the faulty 
message, that looks something like this: 

Figure 2-4 Mail Facility Message To Originator When User Unknown 

' "N 

Unix-From: medici Thu Oct 31 23:59:59 1985 
Return-Path : <MAILER-DAEMON> 

Received: by venus.sun.uucp (3 . 0/ SMI-3 . 0) 

id AB09802; Thu, 31 Oct 85 23:58:59 PDT 
Date: Thu, 31 Oct 85 23:58:59 PDT 
From: MAILER-DAEMON (Mail Delivery Subsystem) 

Subject: Returned mail: User unknown 
Message-Id: <8510220038 .ABO 9 8 02 ©venus .sun.uucp> 

To: medici 

Transcript of session follows 

550 amorphous... User unknown 

Unsent message follows 

Return-Path: <medici> 

Received: by venus.sun.uucp (3 . 0/SMI-3 . 0) 

id AA09798; Thu, 31 Oct 85 23:58:59 PDT 
Date: Thu, 31 Oct 85 23:58:59 PDT 
From: medici (Cosimo de' Medici) 

Message-Id: <8510220038 .AA.O97 980venus.sun.uucp> 

To : amorphous 
Subject: Greetings! 

What are you up to, 
old pal? 

s / 
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3) The mail facility delivers a mail message that looks something like this 
to your machine’s Postmaster: 



Figure 2-5 Mail Facility Message To Postmaster When User Unknown 



Note: The Postmaster for a given 
machine is a username designated 
to receive notice of messages that 
the mail facility cannot deliver. 
Probably, either you or your system 
administrator will be the Postmaster 
for your machine. 


r > 
Unix-From: medici Thu Oct 31 23:59:59 1985 
Return-Path: <MAILER-DAEMON> 

Received: by venus.sun.uucp (3 . O/SMI-3 . 0) 

id AA09802; Thu, 31 Oct 85 23:58:59 PDT 
Date: Thu, 31 Oct 85 23:58:59 PDT 
From: MAILER-DAEMON (Mail Delivery Subsystem) 

Subject: Returned mail: Mail problem 
Message-Id: <8510220038 .AAO 9 8 020 venus . sun .uucp> 

To: Postmaster 




Transcript of session follows 

550 amorphous... User unknown 




Message header follows 

Return-Path: <medici> 

Received: by venus.sun.uucp (3 . O/SMI-3 . 0) 
id AAO 97 98; Thu, 31 Oct 85 23:58:59 PDT 
Date: Thu, 31 Oct 85 23:58:59 PDT 
From: medici (Cosimo de' Medici) 

Message-Id: <8510220038 . AA09798@venus . sun .uucp> 

To : amorphous 
Subject: Greet ings ! 

l j 




The mail facility delivers to the Postmaster notice of the mail message you sent 
without delivering the message text; so your mail is still somewhat confidential, 
even when you make a mistake. 


Aborting a Mail Message 


When you have started to send a message, but you decide you no longer want to 
send it. tvpe vour interrupt character . usuallv f CTRL-C 1. to abort the message, 
mail displays a message asking you to confirm the message abort by typing 
; CTRL-C 1 once again, mail won’t send a mail message when vou abort it 
using the second ( CTRL-C 1. 


Figure 2-6 


Aborting an Attempt at Sending a Mail Message 


Note: When you want to abort a 
message while typing the subject, 
you must type f RETURN ) after the 
first I CTRL-C 1 to aet mail to inter- 
pret the interruption properly. 


r ' 

venus % mail nowhere 
Subject: Over the Rainbow 

Some electronic mail is not meant for anyone to~C 

(Interrupt — one more to kill letter) 

*Cvenus% 

s. J 
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2.2. Summary 



In this chapter, you learned the quickest way to send a mail message. Next, you 
can learn how to read your mail. 
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Reading Mail 



mail is an interactive program that permits you to: 

□ Look at a numbered list of mail messages 

□ Read mail messages 

□ Save mail messages selectively to files 

□ Sort mail messages into folders 

□ Delete mail messages 

This chapter describes all these operations and explains how to read mail mes- 
sages you have saved in files and folders. 7 



3.1. Starting mail 



To start mail so that you can read your mail messages, type mail, without 
any arguments, to the command prompt. 



Figure 3-1 Starting mail To Read Messages 

f >. 

venus % mail 

Mail version SMI 3 . 0 Mon Feb 17 00:20:58 PDT 1986 Type ? for help, 
"/usr/spoool/mail/medici" : 2 messages 2 new 

>N 1 medici Thu Oct 31 23:59 12/323 Mail To Myself 

N 2 MAILER_DAEMON Fri Nov 1 00:02 26/725 Returned Mail: User un 

& 

v > 



mail displays the program name, program version number, and version date, 
then informs you that you can type a question mark (?) to get help information. 

On the second line, mail specifies which file it picks up your mail from, in 
other words your mailbox, tells you how many messages you have, and whether 
they are new or unread. In the example above, the mailbox directory is 
/usr/spool/mail/medici, with two new messages. 



7 When you are using Sun View, the window system and text facility, you may prefer the mailtool 
window and mouse interface to the mail facility. 
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Starting on the third line, mail displays a numbered list of the messages in 
your mailbox. Each of these lines specifies: 



Note: All messages that are neither 
new (N) nor unread (u) are old mes- 
sages that you have read (no status 
indicator), mail marks messages 
you’ve saved to a file or folder with 
an asterisk character (*). 



message status 
message number 
originator 
time sent 
size 



New (N), unread (U), or old (no message status listed) 

Number you can use to specify that message 

Name of user (sometimes machine) message came from 

Date and time originator sent the message 

Number of lines, number of characters, in message 



Note: The current message is the 
message that you last read, or the 
first message you read by default 
when obtaining new mail. Within 
the numbered list of messages, a 
greater-than symbol (>) prefaces 
the current message listing. 



The line beginning with a greater-than symbol (>) is the current message. 

In the example, the N means the message is new; 1 is the message number; 
me dici is the originator; Thu Oct 31 23 : 59 is the date and time 
medici sent the message, and 12/323 means there are 12 lines and 323 char- 
acters in the message. 

Finally, mail displays an ampersand prompt (&) to let you know you can type 
mail commands. 

If you start mail when you don’t have any messages waiting for you in your 
mailbox, you will see something like this: 



Figure 3-2 Starting mail with an Empty Mailbox 



r 


>1 


venus % mail 




No mail for medici 




venus % 




v 


J 



Each time you log in, your machine informs you if you have mail in your system 
mailbox by displaying 



You have mail. 



on a line by itself just after your regular login messages. 



3.2. How To Read Mail Once you have entered mail and examined the numbered list of mail messages, 

Messages you can read a given message by typing its message number to the mail 

prompt 

For the initial example above, there are two messages, with message numbers 
one and two. Type 1 to the mail prompt, and mail displays the first mes- 
sage. 
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Figure 3-3 



Reading a Mail Message 



venus % mail 

Mail version SMI 3.0 Mon Feb 17 00:20:58 PDT 1986 Type ? for help, 
"/usr/spoool/mail/medici" : 2 messages 2 new 

>N 1 medici Thu Oct 31 23:59 12/323 Mail To Myself 

N 2 MAILER_DAEMON Fri Nov 1 00:02 26/725 Returned Mail: User un 

& 1 

Message 1: 

From medici Thu Oct 31 23:58:59 1985 
Return-Path: <medici> 

Received: by venus . sun .uucp (3 . O/SMI-3 . 0) 

id AA12623; Thu, 31 Oct 85 23:59:59 PDT 
Date: Thu, 31 Oct 85 23:59:59 PDT 
From: medici (Cosimo de' Medici) 

Message-Id: <8510232235 . AA12623@venus .sun .uucp> 

To: medici 
Status: R 

Introspection is a narcissistic pursuit. 

& 



3 3 . Looking at the Numbered Now that you have read the first message in your mailbox, when you next look at 

Mail Message List the numbered mail message list, die N status of that message no longer appears. 

To look at the numbered mail message list, type headers, or just h, to the 
mail prompt 



Figure 3-4 Looking at the Numbered Mail Message List 





















> 


& h 


> 


1 


medici 


Thu 


Oct 


31 


23:59 


12/323 


Mail To Myself 




N 

& 

s 


2 


MAILER DAEMON 


Fri 


Nov 


1 


00:02 


26/725 


Returned Mail: 


User un 
> 



The N, for new message, no longer appears just after the greater-than sign; you 
changed the status of the message when you read it. 



3.4. Reading the Current 
Mail Message 



Instead of specifying the message number, you could type print to the mail 
prompt to read the current message in your mailbox, p works as an abbrevia- 
tion for print. 
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Figure 3-5 Reading the Current Mail Message 





& p 

Message 1 : 

From medici Thu Oct 31 23:58:59 1985 
Return-Path: <medici> 

Received: by venus . sun .uucp (3 . O/SMI-3 . 0) 

id AA12623; Thu, 31 Oct 85 23:59:59 PDT 
Date: Thu, 31 Oct 85 23:59:59 PDT 
From: medici (Cosimo de' Medici) 

Message-Id: <8510232235 .AA1 2 62 3 6 venus .sun.uucp> 

To: medici 
Status : R 

Introspection is a narcissistic pursuit. 

& 

s > 



As another alternative, when you want to read the next mail message in the list, 
simply type I RETURN 1 . 



3.5. Mail Message Format What is all that stuff in the mail message? 

A mail message has two parts: the header and the body. When you send a mail 
message the quick way you learned in Chapter 2 , you don’t see the header, 
except for the Sub j ect : field. When you compose a message in Chapter 4 , 
you’ll see more of the header. But mostly, you see the header when reading your 
mail. 

The header comprises a number of fields. Fields describe attributes of the mail 
message, such as: 



Return-Path : 


Address used to return mail that is undeliverable 


Received: 


Machine, message identification information, and 
arrival time for each machine along the message’s 
network path. 


Date : 


Time sent, including date 


From: 


Username (sometimes machine name) of message 
originator 


Message-Id: 


Message identification information 


To : 


Username (sometimes machine name) of message 
recipient 


Subject : 


Subject of message 
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You can set up mail so that you don’t see certain mail message header fields. 
See the Man Page, online or in the Commands Reference Manual , for more infor- 
mation. 

The text of your message that appears below the message header is called the 
message body. 



3.6. Saving Mail Messages in To save a mail message into a file, type save, or the abbreviation s, followed 

Files by the message number and the filename of the file you want to contain the mes- 

sage. mail responds by displaying the filename, followed by the status of the 
file, and the size of the file. 

For example, to save the first mail message in the example user’s mailbox into 
the file first .mail: 

Figure 3-6 Saving a Mail Message into a File 

Note: When you save a message 
to a file, but you don’t specify which 
message number, mail assumes 
that you want to save the current 
message into the filename you 
specify. 



r 














& h 














> 1 medic i 


Thu Oct 


31 


23:59 


12/323 


Mail To Myself 




N 2 MAILER DAEMON 


Fri Nov 


1 


00:02 


26/725 


Returned Mail: 


User un 


& s 1 first .mail 














"first .mail” [New file] 


12/333 












s 















Now, the file f i r s t . ma i 1 contains the header and body of mail message 
number one. 



3.7. Saving Mail Messages in A folder is a special kind of file that you can use to store and organize your mail 
Folders messages. Saving a mail message in a folder is like saving a mail message in a 

file. You can often distinguish a folder from a file because folders generally 
begin with a plus sign (+)• 



Note: The initial plus sign on a 
folder name is an abbreviation for 
the directory you specify with the 
folder variable in your .mailrc 
file. 



Before using folders, you must choose a directory with name directory-name , for 
example storage, into which mail will locate all folders with names that 
have an initial plus sign. Indicate that folder name to the mail facility by putting 

set folder=directory-name 

on a line by itself in your .mailrc file. 

To save a mail message in a folder, type 



save message-number +foldername 



to the mail prompt. 

To save example message number one into a folder called testmail: 
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Figure 3-7 



Note: The asterisk (*) in the num- 
bered message list indicates that 
you have saved that message into a 
file or folder. The asterisk replaces 
any new (n) or unread (u) message 
status indicator when you save a 
message. 



Saving a Mail Message into a Folder 



r 












& h 


>* 1 medici 


Thu Oct 


31 23:59 


12/323 


Mail To 


Myself 


N 2 MAILER_DAEMON 

& save 1 +testmail 

,, +testmail ,, [New file] 

& 

v 


Fri Nov 
12/333 


1 00:02 


26/725 


Returned 


Mail: User un 

> 



3.8. Quitting mail To quit mail, type quit, or the abbreviation q, to the mail prompt. 

The quit command moves any messages you haven’t saved in a file or folder 
from your mailbox into a file called mbox in your home directory. For exam- 
ple, when you have two messages which you read, but didn’t save in a file or 
folder, mail displays the notification: 

Saved 2 messages in mbox 



When you quit mail without reading a mail message that appeared in the num- 
bered mail message list, mail will hold the unread message in your mailbox. 
Then, when you start mail again, the unread mail message will reappear in the 
numbered mail message list with a message status unread (U). 

Figure 3-8 Quitting mail 



& q 

Held 1 message in /usr/spool/mail/medici 
venus % 

S J 
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3.9. Reading Messages in a You can use an editor to look at mail messages that you’ve saved in a file, or you 

File can read the messages with the mail program. To use mail, type mail fol- 

lowed by the option -f filename. For instance, to read the example message 
saved in the file f ir st . mai 1 : 

Figure 3-9 Reading a Mail Message Saved in a File 

f > 

venus % mail -f first .mail 

Mail version SMI 3.0 Mon Feb 17 00:20:58 PDT 1986 Type ? for help. 

’’first .mail" : 1 message 1 new 

> 1 medici Thu Oct 31 23:59 12/323 Mail To Myself 

& p 

Message 1: 

From medici Thu Oct 31 23:58:59 1985 
Return-Path: <medici> 

Received: by venus . sun .uucp (3 . O/SMI-3 . 0) 

id AA12623; Thu, 31 Oct 85 23:59:59 PDT 
Date: Thu, 31 Oct 85 23:59:59 PDT 
From: medici (Cosimo de' Medici) 

Message- Id: <8510232235 . AA12 623 @ venus . sun .uucp> 

To: medici 
Status: R 

Introspection is a narcissistic pursuit. 

& q 

"first. mail” complete 
venus % 

s > 



When you save a message in a file, mail won’t move it automatically into the 
mb ox file. However, mail notifies you that the mail message is still in the file 
by displaying "filename" complete, or in the case of this example 
"first .mail" complete. 
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3.10. Reading Messages in a Reading a message saved in a folder is similar to reading a message saved in a 
Folder file — type mail followed by the option -f +foldername. For instance, to 

read the example message saved in the folder +testmail: 

Figure 3-10 Reading a Mail Message Saved in a Folder 




When you save a message in a folder, mail won’t move it automatically into 
the mbox file. However, mail notifies you that the mail message is still in the 
folder by displaying xx folder name " c omp 1 e t e , or in the case of this example 
,, +testmail" complete. 

3.11. Deleting Mail Messages To delete a mail message, type d, for delete, followed by a space character, and 

the message number of the message. 

Figure 3-11 Deleting a Mail Message 
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3.12. Summary In this chapter, you learned how to read mail messages, save them into files and 

folders, read the messages you saved in files and folders, and delete mail mes- 
sages. 



#sun 

\r microsystems 




4 



Composing Mail Messages 

Composing Mail Messages 29 

4.1. Composing a Mail Message Using vi 29 

4.2. Adding a Carbon Copy to Someone Else 32 

4.3. Aborting a Mail Message 33 

4.4. Composing a Mail Message While Reading Your Mail 33 

4.5. Sending Mail Messages Over Local Networks 33 

4.6. Summary 34 





4 



Composing Mail Messages 



When you want to send a mail message without worrying about mistakes you 
type in the message text, you can compose the message using the vi text edi- 
tor. 8 This chapter describes how to: 

□ Compose a message using vi within the mail program 

□ Carbon copy the message to other users 

□ Abort a mail message 

□ Compose a mail message while reading your mail 

□ Send mail over local networks. 9 



4.1. Composing a Mail To compose a mail message using vi, first type a mail message as you learned 

Message Using vi in the chapter on sending a mail message (Chapter 2 ). In other words: 

□ Type mail 

□ Wait for the Sub ject : prompt 

□ Type the subject of the message 

□ Type f RETURN! 

□ Type any of the message body text you desire 
Next start vi: 

□ On a line by itself, type ~ v 

□ Type fRETURNI . 

The tilde character (~) signals mail to interpret the following character (v) as a 
command, in this case a command to start up the visual text editor vi. 



8 For more information about vi, see the chapter on editing files in Getting Started With UNIX: Beginner's 
Guide. 

9 For information on sending mail over remote networks, see Chapter 9 . 
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Figure 4-1 


Starting vi From Within mail 






r 

venus % mail wilde 

Subject : The Importance of Being Earnest 
~v 


\ 






* 



After a moment, the vi interactive screen appears, ready for you to edit an 
empty file located in your /tmp directory. 



Figure 4-2 



The vi Interactive Screen and Temporary File 



I 



,, /tmp/Re6374 n 0 lines, 0 characters 
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Next, type i to insert the message text. 10 Type the message text, followed by 
[ ESC) to tell vi that you’ve entered all of the text. Then, type a colon ( : ) to 
enter colon mode, followed by wq and a carriage return to write, or save, the 
file, and to quit vi. 



Figure 4-3 



Entering the Message Text Using vi 



Ignorance is like a delicate exotic fruit; 
touch it and the bloom is gone. 



:wq| 



10 The text is from Oscar Wilde’s The Importance of Being Earnest. 
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mail displays ( continue ) to let you know when it takes over from vi. At 
this point, you can type in more message text, or type \ CTRL-D 1 to end the mes- 
sage text and send the mail message. Once again, the ~D symbol on the screen 
changes to EOT, end of text, as mail acknowledges your instructions and 
sends the mail message. 

Figure 4-4 Returning from vi to mail and Sending the Mail Message 

— 



,, /tmp/Re6374 ,, 2 lines, 75 characters 
(continue) 

EOT 

venus % 

< J 

You have successfully composed and sent a mail message using vi within 
mail. 

When you can’t remember one of the mail commands beginning with the tilde 
character, type the tilde character followed by a question mark (“ ?) and 
( RETURN 1 to get a list of such commands. 

4.2. Adding a Carbon Copy to Before you send your mail message, you can specify that a carbon copy of the 
Someone Else message go to additional users. 

Do so by typing the tilde character (~), letter c, a space character, and the user- 
names you want to receive a carbon copy, each separated by a space character. 
Then send the mail message as usual by typing 1 CTRL-D J . 
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4.3. Aborting a Mail Message 



Aborting a mail message from within vi isn’t all that different from aborting a 
regular mail message. Quit vi to return to mail — type 



(BED :wql 



then, when you’ re back in mail, type 



twice in succession. 



4.4. Composing a Mail 

Message While Reading 
Your Mail 



When you want to compose a mail message while reading your mail, starting 
with the ampersand mail prompt (&), rather than the command prompt, you 
can type m followed by the username(s) of the mail recipient(s) and 1 RETURN 

mail responds just like it does when you compose a message starting from the 
command prompt. So type: 

□ The message subject to the Subject : prompt 



□ The message text 

□ [ CTRL-D ) to send the message 

You’ll end up back at the ampersand mail prompt where you can continue to read 
your mail. 



When your local network doesn’t include the yellow pages facility that automati- 
cally determines machine names associated with a username, you must specify 
the machine name along with the username of the person you are sending a mail 
message. 

Construct a mail address with the username, an at-sign (0), and the user’s 
machine name. For example, to send mail to user stein at machine rose, 
type stein@rose as the mail address. 11 

Figure 4-5 Sending Local Network Mail: Mail Address That Includes the Machine Name 




4.5. Sending Mail Messages 
Over Local Networks 



11 The message text in the example is from How to Write written by Gertrude Stein between 1927 and 1931 . 
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4.6. Summary Now you can compose a mail message using vi within mail. You can pro- 

duce carbon copies of your mail and compose a mail message while reading your 
mail. You can abort the mail message when you decide you don’t want to send 
it. And you can send mail on a local network that isn’t running the yellow pages. 
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Replying to Mail 



After you read a mail message, you may want to reply to it, to answer questions 
or make comments. When you reply to the message, you can insert a copy of the 
message you’re answering into your reply message. This chapter tells how. 

This chapter also explains how to insert a copy of a file into a mail message. 



5.1. Replying to a Mail After reading a mail message, you can reply by typing reply message number 

Message to the mail prompt, r works as an abbreviation for reply. 

The example shows how you can read a message, then reply by typing only r, 
for reply, mail assumes you’re replying to the current message when you 
don’t specify a message number. 

mail constructs the To : and Subject : fields automatically from the mail 
message you’re answering. It replies to the sender of the original mail message 
and precedes a copy of the original subject line with the string Re : . 

Type I CTRL-D ) on a line by itself to send the mail when you’ve finished enter- 
ing the message text 
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Figure 5-1 

Note: For the purpose of the exam- 
ples in this chapter, assume that 
users sappho and rimbaud sent 
the example mail messages. You 
can generate mail by sending mail 
to yourself or waiting for a colleague 
to send you some. 



Replying to a Mail Message 

r -> 
venus% mail 

Mail version SMI 3.0 Mon Feb 17 00:20:58 PDT 1986 Type ? for help, 
"/usr/spoool/mail/medici" : 2 messages 2 new 

>N 1 sappho@aphrodite Thu Oct 31 23:59 21/391 Love and Sun 

N 2 rimbaud0verlaine Fri Nov 1 00:02 16/515 Vagabonds 

& p 

Message 1: 

From sappho@aphrodite Fri Nov 8 13:09:46 1985 
Return-Path: <sappho@aphrodite> 

Received: by venus.sun.uucp (3 . O/SMI-3 . 0) 

id AA09267; Fri, 8 Nov 85 13:09:36 PST 
Date: Fri, 8 Nov 85 13:09:36 PST 
From: sappho@aphrodite (Sappho) 

Message- Id: <8511082109 . AA0 9267 @ venus . sun .uucp> 

To: medici@venus 
Subject: Love and Sun 
Status: R 

I confess 

I love that 
which carresses 
me. I believe 

Love has his 
share in the 
Sun's brilliance 
and virtue 

& r 

To: sappho@aphrodite 
Subject: Re: Love and Sun 

In the words of the popular band Ministry: 

"Oo, you got to work for love." 

EOT 

& 

s > 



As usual, mail confirms the end of text of the message with EOT, then sends 
the message. 12 



5.2. Inserting a Copy of a 
Mail Message 



Note: Inserting a copy of a mail 
messag e with ~ m message number is 
something like entering vi from 
mail by typing ~v. 



To insert a copy of the message to which you are replying within the text of the 
reply: 

□ Reply to the message using reply message number 

□ Typing the tilde character (~) and m, for message, and an optional message 
number 

o Type [RETURN! . 



The poem is by Sappho. 
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Even though you can’t see the text of the inserted mail message, mail inserts 
the message you specify into the message you are preparing to send, mail 
confirms the operation by displaying the notification Interpolating : fol- 
lowed by the message number, and (continue ) on the next line. 

The inserted message appears indented eight characters from the left margin of 
the message text. 13 This is useful when you want to further edit the message with 
vi, adding pertinent comments right near the appropriate parts of the original 
message. 

End the message text as usual by typing a I CTRL-D 1 on a line by itself. 

Figure 5-2 Inserting a Mail Message into Your Reply 



r 




& r 




To: sappho0aphrodite 
Subject: Re: Love and Sun 




~m 

Interpolating: 1 
(continue) 

What a beautiful poem, my dear! 

EOT 




& 




V 


J 



13 When you want to insert a message without indentation, use ' f instead of ~ nu 
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In this example, user sappho receives a message that looks like this: 



Figure 5-3 

Note: In the example, user 
sappho’s machine name is 
aphrodite. 



Inserted. Mail Message After Delivery of Reply 

< ■> 
aphrodite% mail 

Mail version SMI 3.0 Mon Feb 17 00:20:58 PDT 1986 Type ? for help, 
"/usr/spool/mail/sappho" : 2 messages 2 new 

>N 1 medici Fri Nov 8 14:13 13/374 Re: Love and Sun 

N 2 medici Fri Nov 8 14:14 33/722 Re: Love and Sun 

& 2 

Message 2: 

Date: Fri, 8 Nov 85 14:14:04 PST 
From: medici (Cosimo de' Medici) 

Message-Id: <8511082214 .AAO943O0oscar.sun.uucp> 

To: sappho@aphrodite 
Subject: Re: Love and Sun 

Status: R 

From sappho0aphrodite Fri Nov 8 13:57:32 1985 
Return-Path: <sappho0aphrodite> 

Received: by venus . sun .uucp (3 . O/SMI-3 . 0) 

id AA09370; Fri, 8 Nov 85 13:57:15 PST 
Date: Fri, 8 Nov 85 13:57:15 PST 
From: sappho0 aphrodite (Sappho) 

Message-Id: <8511082157 . AA0 93700 venus . sun ,uucp> 

To : medici 

Subject: Love and Sun 
Status: R 

I confess 

I love that 
which carresses 
me. I believe 

Love has his 
share in the 
Sun's brilliance 
and virtue 

What a beautiful poem, my dear! 

& q 

Saved 1 message in /usr/sappho/mbox 
aphrodite% 

< 



53. Inserting a Copy of a File 



Note: When you’re inserting a copy 
of a file from another directory, use 
the absolute pathname to specify 
the filename. 



Inserting a copy of a file into a mail message is like inserting a copy of a message 
into another message. Start to send a mail message, or reply to a mail message as 
before, only type the tilde character ( ~ ) and r filename, followed by I RETURN I . 
mail will insert the file called filename into your mail message. Type 
f CTRL-D 1 to end the message text and send the message. We continue with user 
medici as he struggles to form a more satisfactory reply to sappho: 



Asun 

microsystems 






Chapter 5 — Replying to Mail 4 1 



Figure 5-4 Inserting a File into a Mail Message 

^ 

& r 

To: sappho0aphrodite 
Subject: Re: Love and Sun 

~r blank. verse 

"blank. verse" 0/0 
EOT 

Null message body; hope that's ok 

& q 

Saved 1 message in /usr/medici/mbox 
Held 1 message in /usr/spool/mail/medici 
venus % 

S 



When you send a message that doesn’t contain any characters in its body, mail 
presents the notification 

Null message body; hope that's ok 
while sending the message. 

With this method of inserting a file into mail messages, you can insert files into 
an original message as you compose it, or into messages to which you’re reply- 
ing. 



5.4. Summary You have successfully replied to a mail message, inserted a mail message into 

another mail message, and inserted a file into a mail message. That covers the 
basics of the mail program. 

For more information about mail, like how to reply to a message with a copy 
to all the recipients of the original message, see the mail Man Page, online or 
in the Commands Reference Manual. 
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The Window-Based mailtool 



mailtool is a window and mouse mail program, so you must run it in within 
suntools, the SunView window system, mailtool allows you to view, 
store, compose, and send mail messages. It provides a powerful interface for 
mail operations, including scrollable windows, a command panel, and most of 
the features of the text facility. 

Although mailtool provides the SunView capabilities, it sends the com- 
mands to the mail program through a pipe, or software connection, between 
the two programs. 

Read Windows and Window-Based Tools: Beginner’s Guide for the basics of 
how to run a window-based tool, before reading this chapter to learn the specifics 
of mailtool. 

Figure 6-1 mailtool 




mailtool icon 



KPffq B HBBjMi i w ii m p g W , ri VlWP 



> g medici 
N 3 sappho 



Hon Nov 18 11: 12 
Hon Nov 18 11: 16 



25/607 Test 
29/836 Banzai 



show 



DC next 1[ delete )[ undelete print ~)['neu mailljt done ] 
"*) [ compose ] [ coniim t ] 



[ save"~^[ copy )Fi le: 



f'foTJer'T 



From sappho Non Nov 18 ill i2:' 34 1’55S ' 

Return-Path: <medici> 

Received: by oscar. sun. uucp (3.0DEV2/SHI-2.0) 

id A 006979; Hon, 18 Nov 85 11:12:24 PST 
Date: Hon, 18 Nov 85 11: 12: 2M PST 
From: medici (Cosimo de' Hedici) 

Hessage-Id: <8511181912. fiA06979«oscar . sun. uucp> 

To: test, wild 
Subject: Test 
Status: R 

From wild Thu Nov 14 13:49:53 1985 
Return-Path: <uild> 

Received: by oscar . sun. uucp (3. 0DEV2/SHI-2. 0) 

id HA01999; Thu, 14 Nov 85 13:49:37 PST 
Date: Thu, 14 Nov 85 13:49:37 PST 
From: wild (Will Doherty) 

Hessage-Id: <8511142149. ft A01999@oscar. sun. uucp> 
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6.1. mailtool Options mailtool accepts all the standard window-based tool options, plus 

-x expert mode, don’t ask for confirmation of commands 

-i # check for new mail every # seconds (default 5 minutes) 

6.2. Selecting a Mail Message To select , or choose, a mail message, click, or press and release, the left mouse 

button anywhere in the header window line that corresponds to that message. 

63. mailtool Buttons You can execute all of the mail operations using mailtool in a way you’ll 

probably find easier. For instance, you can select many of the operations by 
clicking the left mouse button on command panel buttons. 



Figure 6-2 mailtool : Command Panel Subwindow Buttons 




"next "M delete If undelete )( print "if new ■mT>[ done 
r repiM cowpose j t combi Q 

copM 1 F1 le: 



This list describes briefly the function of each button on the mailtool com- 
mand panel. All buttons except I next 1 and [ undelete 1 operate on the currently 
selected message. You have to scroll the command panel to permit access to 
some of the buttons. 

( abort! 

Quit the tool without modifying your system mailbox 

1 cdl 

Change to the directory specified in the Directory: text item 
[ cancel! 

Abort the message you’re composing in the composition subwindow 
[ commit I 

Commit changes to your system mailbox 
I compose! 

Open the composition subwindow to compose, or forward, a message 
1 co py J 

Copy the selected message to the file or folder specified in the File : text 
item 

[ deliver 1 

Send the message you’re composing in the composition subwindow 
( delete 1 

Delete the selected message 
( done ) 

Commit changes and close the tool 
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Note: Don’t treat the system mail- 
box as a folder or you may damage 
some of your mail. When you want 
to get new mail, select the 
1 new mail 1 button. 



i folder J 

Commit changes and switch to the file or folder specified in the File : 
text item 

( new mail 1 

Commit changes and reread the system mailbox to see new mail 

[ next ] 

Show the next message in the message subwindow 
( preserve ) 

Hold the selected message in system mailbox after next commit 
1 print ] 

Print the selected message on a hardcopy printer 
[Quit] 

Commit changes and quit the tool 
i reply] 

Open the composition subwindow to reply to the selected message 
I save 1 

Save the selected message in the file or folder specified in the File: text 
item 



I show I 

Show the selected message in the message subwindow 
I undelete 1 

Undelete the most recently deleted message(s) — can repeat use 
I .mailrc ) 

Source your ~ / . mailrc file to acquire the current option settings 



6.4. Replying, Composing, 
Replacing, and Folders 



[ reply 1 (and I compose B split the message subwindow; the reply message appears 
in the bottom portion. 14 Also, I deliver 1 and [ cancel 1 buttons appear. When you 
finish editing the reply, press the [ deliver I button to hand the message back to 
mail for delivery; the reply subwindow disappears. The I cancel 1 button can- 
cels the message. 

You can replace a message with an edited version of the message. When you 
edit a message, then press any button, mailtool will ask if you want to save 
the edited message. Click the left mouse button to confirm that you want to 
replace the message in the folder with the message you edited. 

Just as in mail, folder names are generally a plus sign (+) followed by the 
name of the folder, for example +meet ings . 



14 You can specify the proportions for the split of the message subwindow by setting the msgpercent 
option in the Mail category of defaultsedit. For more information, see the section on 
def aultsedit in the chapter on other editing tools from Windows and Window-Based Tools: Beginner’s 
Guide. 
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6.5. Text Items 



6.6. mailtool Menus 



6.7. Accelerators to 
mailtool Buttons 



Note: Remember that folder names 
are of the form +folder and are 
relative to the directory specified by 
the folder variable. 



Text items in the command panel are: 

File: hlelfolder name for I save I . fco p v ), and f folder 1 . 

Directory: current directory 



One type of menu in the command panel is the button command menu. 

Button command menus extend the functionality of the button command by pro- 
viding variations on that command or related commands. Experiment with these 
menus by pressing the right mouse button while the cursor is over the button. 

For instance, pressing the right mouse button on I next 1 pops up a menu with 
next and prev items, so you can decide to view the previous message, instead 
of the next message. 



All command panel button menus have corresponding keyboard accelerators. 
You can use the I SHIFT 1 and I CTRL1 keys to perform the accelerations. 



In general, if a command has an inverse function, like reversed direction, use the 
( SHIFT 1 key on that button to invoke the inverse operation. 15 Use f CTRL 1 to 
strengthen a command or invoke a related function. 

When a menu has actions corresponding to all four combinations of [ SHIFT] and 
f CTRL) , you can accelerate the menu items as follows: 

Menu item 1 Click on the button 



Menu item 2 
Menu item 3 
Menu item 4 



Hold f SHIFT 1 while clicking on the button 
Hold I CTRL 1 while clicking on the button 
Hold I SHIFT 1 and I CTRL I when clicking on the button. 



With this organization of commands, you can leam the keyboard accelerators 
quickly by browsing the button menus to discover what additional commands are 
available. 



The other type of command panel menu is the file menu. The menu behind the 
[ folder I button shows you all your folders. The menu behind the File : text 
item holds the most recendy used file (and folder) names. Selecting a name from 
these menus replaces the contents of the File : item just as if you typed the 
name. This name is used for the ( save I . ( copy 1 , and I folder 1 commands. 
Filenames typed into the File : field are relative to the directory specified in 
the Directory: field. 

To switch to a folder, select it from one of the file menus or type directly into the 
File : text item, and press the 1 folder 1 button. 



15 The sense of opposite direction may be modified by the allowreversescan specification in a 
.mailrc file located in your home directory; run default sedit. See Windows and Window-Based Tools: 
Beginner’s Guide for more information. 
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To return to your system mailbox, use the ( new mail! button — do not use your 
system mailbox as a folder. 



6.8. Variables in the 
.mailrc File 



mailtool interprets several variables in addition to those of mail. You can set 
these variables in your . mai lr c file, located in your home directory, using 
defaultsedit. 



allowreversescan 

Allows you to work through your mailbox in the reverse, as 
well as forward, directions. This will affect which message is 
next - if the sense of direction is reverse then the message 
displayed by I next 1 is actually the previous one. 

autoprint Display the next message when the current message is deleted 
or saved 



bell 

cmdlines 

expert 



f ilemenu 



Number of times to ring the bell when new mail arrives 

Number of lines in command panel 

Sets expert mode — no confirmations required (same as the 
-x option) 

List of files to initialize the File : menu, for example 
+mbox +trash 



f ilemenusize 



flash 

headerlines 

interval 

maillines 

msgpercent 

printmail 



Specifies the maximum size of the File : menu 

Number of times to flash the window or icon when new mail 
arrives 

Number of lines in header subwindow 

Interval in seconds to check for new mail (same as the - i 
option) 

Number of lines in mail message subwindow 

Percent of the message subwindow to remain visible during a 
reply or compose operation 

The command to use when printing mail — default is lpr 



-P- 



trash Name of trash bin (if set to +t rash, you can access it like 

any other folder) 

When you’ve set the trash variable, mailtool moves all deleted messages 
to the trash bin. You can look at the trash bin as with any other folder by typing 
its name to the File : item and pressing the [ folder 1 button. You empty the 
trash bin when you press I done I . 

You can make your .mailrc file set a variable conditionally, depending on 
whether it’s running within or outside of suntools, the window environment. 
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The command if t tests whether you’re running mail from a terminal at die 
time you read the . mai lr c file. For example, when you insert: 

if t 
else 

set autoprint 
cd 

endif 



Caution: Using the if t condi- 
tional expression in your .mailrc 
also affects the mail when used in 
other ways, as with pipes. 



into your .mailrc file, mailtool sets the mail variable autoprint 
and changes to your home directory when you start mailtool within the win- 
dow environment. 16 



6.9. Reopen Reads New Mail If you close mailtool with I done 1 . when you reopen it mailtool reads 
Automatically your new mail automatically (as if you had selected I new mail 1 after opening the 

tool). When you close mailt ool with the close menu item, or one of the 
accelerators, mailtool won’t automatically read in new mail. 



6.10. Printing Mail with The I print 1 button prints the message using the command line you specify with 

mailtool the printmail variable. 

By default, printmail is assigned to lpr -p and uses the default printer, 
as specified by the PRINTER environment variable. 



6.11. The Trash Bin You can set the trash variable to a file or folder name. When you do so, 

mailtool moves all deleted messages to the “trash bin” file or folder you 
chose. You can look at the trash bin by typing the name of the trash bin file or 
folder to the File : text item and pressing the I folder 1 button. The trash bin 
empties — “taking out the trash” — when you press I done 1 . 



16 For more information on the .mailrc file, see the mail Man Page, online or in the Commands 
Reference Manual. 
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6.12. Hoisting the Flag for 
New Mail 




mailtool icon — no mail 




mailtool icon — new mail 
6.13. Summary 



When you get new mail, mailtool notifies you that the mail has arrived by 
displaying [New Mail] at die end of the window namestripe. Also, when the 
mailtool is iconic, the little mailbox raises its flag, and a letter appears in its 
mail slot. 

You can the flash and bell mail variables for additional notification of the 
arrival of new mail . 17 



You have learned the basics of mailtool. For more information, see the 
mailtool Man Page, online or in the Commands Reference Manual. 



17 Use de f au It sedi t, described in the chapter on other editing tools from Windows and Window-Based 
Tools: Beginner’s Guide. 
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Messages 



This chapter describes messages, so that you can communicate with other users 
more immediately and interactively than by electronic mail. 

There are three kinds of electronic messages: 

□ Interactive messages with talk or write 

□ Broadcast messages with wall 

□ System messages from your machine 



7.1. Interactive Messages: 

talk 



With the talk program, you can converse on your screen with someone else 
who is either using a terminal on your machine, or using another machine on 
your local network. 



Note: When using the window sys- 
tem, initiate your talk message 
session in the window you want to 
use for the session. Pick a window 
that is large enough to contain a fair 
amount of text. 



Figure 7-1 



To start talk, type talk usernameQmachine-name to your command prompt, 
followed by I RETURN 1 . In this example, user medici attempts to contact user 
michaelangelo. 



Starting a talk Message Session 


venus % talk michaelangelo@david 




s 


> 



talk’s interactive screen appears and talk attempts to connect with the other 
user’s machine. Until talk connects to the other machine, it displays the 
notification: 



[No connection yet] 

Once connected, talk notifies you that it is waiting for the other person to 
respond: 



[Waiting for your party to respond] 



talk “rings” the other person again and again, printing a message repeatedly 
on the screen while waiting for a response. If the other person isn’t a user, or 
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isn’t logged at that time, talk responds with: 



[Your party is not logged on] 

But when talk finds the other user, the talk interactive screen displays a 
line to split itself in half like this: 

Figure 7-2 talk's Interactive Screen 




To facilitate a connection, talk displays a message that includes your user- 
name and machine name on the other user’s screen. In the case of example user- 
name medici’s attempt, talk displays the following message on user 
michaelangelo’s screen: 

Figure 7-3 talk Notifies the Other User 




The other user must respond by typing talk followed by the username and 
machine name of the person who is attempting to talk. In our example, 
michaelangelo types: 

talk medici@venus 

to confirm the talk connection with user me dici on machine venus. 

If michaelangelo is busy, or wants to ignore medici, he refuses to answer 
medici’s request, and eventually medici gives up, typing [ CTRL-C ] to exit 
from the talk interactive screen. 
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However, if michaelangelo successfully responds to medici’s request, 
talk establishes a link between the two users. 



Figure 7-4 



talk Establishes Message Link Between Two Users 




r 

[Connection established] 


\ 


S 


J 



Now, both users can type messages on the screen at the same time without 
interfering with each other. Both users see the messages they’ve typed on the 
upper half of their own screens or windows; the other user’s messages appear on 
the lower half of their screens. 

Figure 7-5 Chatty talk Screen 



r 

[Connection established] 

I sure am hungry. 

How long until the party? 

OK . Bye . (Type f CTRL-C 1 to terminate connection .) 




Well, you can eat at the party. 




Let's go now. 




s 


J 



When they have finished typing messages, either user types [ CTRL-C 1 to ter- 
minate the talk message session. 







To prevent talk messages from appearing on your screen, add 



mesg n 

on a line by itself in your . login file before you start a work session. 

For more information on talk, see the talk Man Page, online or in the Com- 
mands Reference Manual. 



Interactive Messages: write differs from talk because write: 

write 

□ doesn’t use the entire screen or window 

□ only reaches users on the same machine or workstation you’re sending mes- 
sages from 

One user writes a message to the other. Then, the other user can write a 
reply, reply in some other way, or decide not to reply. 

To write a message to someone using a terminal on your machine, type 
write username to the command prompt, followed by \ RETURN) . 

In this example, user medici decides to write some messages to user sap- 
pho. He types in the text of an introductory message on lines following the 
write command line. To send the introductory message text, type [ RETURN] . 

Figure 7-6 Writing a Message to Another User 



r 




venus % write sappho 




Do you want to 




chat? (Type ( RETURN 1 to send message text.) 




s 


J 



The message appears on the other user’s screen almost immediately afterwards. 

sappho decides to exchanges messages with medici, so she types write, 
followed by his username, I RETURN 1 . and her message in reply. 

Figure 7-7 write Message Appears on Another Users Screen 

. 

venus % 

Message from venus.'medici on ttyp2 at 1:01 ... 

Do you want to 
chat? 

write medici 

Sure, what' s up? (Type [ RETURN^ on next line to send message text.) 

S > 



As you can see, write automatically identifies the machine, username, and ter- 
minal where the message originated, and the time the message arrived. 



<3>sun 

V microsystems 






Chapter 7 — Messages 5 9 



The two conversationalists can continue to write messages back and forth, 
without retyping the write command, until they want to stop. Then, both 
users must type 1 CTRL-D 1 on a line by itself to terminate the write connec- 
tion. 

Figure 7-8 Terminating a write Connection 



venus % write sappho 
Do you want to 
chat? 

Message from venus! sappho on ttyp3 at 1:02 ... 

Sure, what's up? 

Oops, I'm late for an 
appointment - gotta 

run ! ( Type [ CTRL-D 1 on next line to send message, terminate connection.) 
venus % 

V 



write displays the end-of-file indicator, EOF on the other user’s screen (for 
this example, user sappho’s screen) to notify that person that her conversa- 
tional partner (user medici) terminated the connection. 

Just as with talk, you can prevent write messages from appearing on your 
screen by adding 



mesg n 

on a line by itself in your . login file before you start a work session. 

For more information on write, see the write Man Page, online or in the 
Commands Reference Manual. 



7.3. Broadcast Messages: 

wall 

Note: Most users sharing a machine 
don’t appreciate people who send 
spurious messages to everyone on the 
machine. 



When you want to send a message to everyone on your machine at once, use the 
wall, write to all, command. Usually, people broadcast messages only to 
announce that the machine is going down for maintenance, or for other important 
messages that affect everyone using the machine. 

Type wall followed by ( RETURN 1 . Then, type the text of the message, fol- 
lowed by I CTRL-D 1 on a line by itself. The message appears on the screen — in 
the console window — almost immediately after you send it. 
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Figure 7-9 Sending a Broadcast Message Using wall 




The same message appears on the screen, or console window, of anyone else who 
is logged in to that machine. 

For more information on wall, see the wall Man Page, online or in the Com- 
mands Reference Manual. 

7.4. System Messages System messages are like broadcast messages, only the system generates them 

automatically to notify you about something that may be important One com- 
mon system message is the message of the day. 

When you log in, you often see two system messages — one about the operating 
system, the other about new mail — shown here as examples: 

Figure 7 - 1 0 Example System Messages 




7.5. Summary In this chapter, you learned about the four types of electronic messages and how 

to send some of them. Now, you’ve covered the basics of both electronic mail 
and electronic messages. 
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Other Features 



A variety of commands can help you read and send mail and messages. 



8.1. Mail From Whom? The When you want to know whom your mail is from, without reading it using 

from Command mail, type f r om to your command prompt. For each mail message waiting in 

your mailbox, from displays From followed by the sender’ s username, and 
the date and time it arrived in your mailbox. 

Figure 8-1 Who’s My Mail From? The from Command 



venus % from 

From sappho0aphrodite Sun Apr 1 8:45:12 1985 
From rimbaud@verlaine Sun Apr 1 8:45:22 1985 
From michaelangelo0david Sun Apr 1 8:45:45 1985 
venus % 

S. > 



For more information on from, see the from Man Page, online or in the Com- 
mands Reference Manual. 



8.2. What’s In My Mailbox? When you want to read the mail in your mailbox without using the mail pro- 

The prmail Command gram, type prmail, for print mail, to your command prompt. For each mail 

message waiting in your mailbox, prmail displays all of the headers and the 
message text 
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Figure 8-2 What’ s In My Mailbox? The prmail Command 

f — n 

venus % prmail 

From sappho@aphrodite Sun Apr 1 8:45:12 1985 

Received: from aphrodite . sun .uucp by venus . sun .uucp (3 . O/SMI-3 . 0) 
id AA00704; Sun, 1 Apr 85 8:45:00 PST 
Return-Path: <sappho@aphrodite> 

Received: by aphrodite . sun .uucp (3 .O/SMI-3 .0) 

Date: Sun, 1 Apri 85 8:45:00 PST 
From: sappho0aphrodite (Sappho) 

Message-Id: <8511132115 . AAOO7410 aphrodite . sun .uucp> 

To: medici@venus 
Subject: Love and Sun 

I confess 

I love that 
which caresses 
me. I believe 

Love has his 
share in the 
Sun' s brilliance 
and virtue 
venus% 

v * 



For more information on prmail, see the prmail Man Page, online or in the 
Commands Reference Manual. 



8.3. Who’s Logged In On 
This Machine? users, 
who, and w 



When you want to find out who’s logged on to your machine, you can use one of 
three commands: users, who, and w. 

The users command displays, in alphabetical order, the username of each per- 
son logged in on your machine. 



Figure 8-3 Who’s Logged In On This Machine? The users Command 



venus% users 
medici rimbaud 
venus% 

s > 



The who command provides more information than users does. For each ter- 
minal running on your machine, who displays the username, the terminal name, 
and the date and time you created the terminal process. 
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Figure 8-4 

Note: In the UNIX operating system, 
processes execute commands. For 
every terminal, there must be at 
least one process executing its 
commands. The process that sup- 
ports a terminal may run without 
any actual piece of hardware — 
what we usually think of as a termi- 
nal — associated with it. Each win- 
dow on a Sun Workstation counts 
as a separate terminal. 



Note: People reboot their machines 
when something goes wrong and they 
want to start the machine from a known 
point, attempting to correct a minor 
problem, or to see if anything is seri- 
ously wrong. 



Figure 8-5 



Note: The line in the figure starting 
with -Ws wrapped around, continu- 
ing from the end of the previous 
line. 



Who's Logged In On This Machine? The who Command 
f 

venus % who 

medici console Apr 1 8:50 

medici ttypO Apr 1 8:51 

medici ttypl Apr 1 8:51 

rimbaud ttyp2 Apr 1 9:36 (verlaine) 

venus % 

s. > 



When a user has logged in to your machine from another machine, the name of 
that machine appears enclosed within parentheses after the rest of the information 
who displays about them. 18 

The w command gives yet more information. First, w displays system informa- 
tion, including the current time, how long since the last reboot of your machine, 
the number of terminals running on the machine, and system load information. 

For each terminal running on your machine, w displays the username, the termi- 
nal name, the time of terminal login, other system information, and what pro- 
gram that process is running. 

Who's Logged In On This Machine? The w Command 





venus% w 



9 : 43am 


up 11:11, 


4 users, load average: 0. 


.76, 0.45, 0.27 


User 


tty 


login@ 


idle 


JCPU 


PCPU 


what 


medici 


console 


8:50am 


3:02 


4:40 


3:59 


clocktool -Wp 120 


-Ws 122 
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medici 


ttypO 


8 :51am 


2 


5:34 


1:14 


vi sculptor . list 


medici 


ttypl 


8 :51am 


94:14 


15 


15 


date 


rimbaud 


ttyp2 


9 : 36am 


1 


5 


5 


-csh 



venus% 

s / 



For more information on users, who, and w, see die appropriate Man Page, 
online or in the Commands Reference Manual. 



8.4. Who’s Logged On Other 
Machines? Using rsh 



On way to find out who is logged in on other machines within your local net- 
work, is to use the users, who, or w command in cooperation with the rsh, 
or remote shell, command. 



18 For more information, see the chapter about login access to other machines in Using the Network: 
Beginner’s Guide. 
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Type r sh, followed by the machine name and command that you want to use. 
For example, when user medici on machine venus wants to find out lots of 
information about the users on machine rose (within medici’s local net- 
work): 

Figure 8-6 Finding Out Who’s Logged In On Other Machines: r sh 

Note: The rsh command may 
take a little while on loaded 
machines or networks. 



Note: The line in the figure starting 
with -Ws wrapped around, continu- 
ing from the end of the previous 
line. 



For more information on rsh, see Using the Network: Beginner s Guide and the 
rsh Man Page, online or in the Commands Reference Manual. 

That finishes the description of other useful commands associated with mail and 
messages. 
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9.1. What Is a Remote 
Network? 



9.2. What Networks Are Out 
There? 



The UUCP Network 



Mail Over Networks 



This chapter describes remote networks for the purpose of understanding how to 
send mail across them. To find out about sending mail on your local network, 
see the chapter on sending mail (Chapter 2 ) and the section on sending mail over 
local networks (Section 4.5 ). For more information about networks in general, 
see Using the Network: Beginner’s Guide. 



Earlier in this manual, you probably read the description of a remote network as a 
network that doesn’t include, at least directly, the machine of the user to whom 
you’re trying to send mail. 

There are many different kinds of networks, each of which has a different syntax 
for the mail address of messages you want to send to the users on those networks. 
Some networks aren’t connected to your network at all, so it is impossible to 
send mail messages to people on those networks. 



For the most part, you are likely only to encounter people you’d want to send 
mail to on one of two major networks: 

o The UUCP network 

□ The Defense Data Network, or ARPANET/MILNET 

Before attempting to send mail to someone on a remote network, you must find 
out which network they’re on. 



The UUCP network is a network of machines that extends across the United States 
and throughout the world. Machines on the UUCP network communicate with 
each other using UUCP, the UNIXt to UNIX copy program. UUCP enables UNIX 
machines to call each other up on phone lines to deliver messages. 



t UNIX is a trademark of AT&T Bell Laboratories. 
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Sending Mail to People on the To send mail to someone on the UUCP network, you must know the network path, 
UUCP Network or sequence of machines the mail message must travel through to get from your 

machine to the recipient’s machine. 
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To find out machine name sequences necessary for mail addresses, ask prospec- 
tive message recipients if they know the appropriate network path. At the least, 
find out the prospective mail recipient’s username and machine name. 19 

You can figure out the prospective recipient’s mail address from this sequence of 
machine names. Pretend to walk along the path between the two machines start- 
ing with the first machine in the sequence and separating each machine name 
with an exclamation point ( ! ), also called “bang.”. Add the recipient’s user- 
name to the end of the address after one last exclamation point. 

Note: uucp mail addresses may get For example, to figure out the mail address that user bilbo on machine 
quite lengthy. shire would use to send mail to user galadriel on machine loth- 

lorien, walk from shire to lothlorien. 

Figure 9- 1 Sequence of Machines in Network 




The sequence of machine names is: oldf orest, bree,and lothlorien. 
The recipient’s username is galadriel . 20 So the complete mail address is: 

oldf orest ! bree ! lothlorien ! galadriel 



19 When the message recipient doesn’t know the appropriate mail address, ask your system administrator, if 
you have one. The system administrator may know offhand, or may have a map of the network. 

20 These names and places come from J.R.R. Tolkien’ s Lord of the Rings. 
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Note: Don’t add backslashes to 
mail addresses within the mail or 
mailtool programs. 



How Does Someone Send Mail 
to Me on the UUCP Network? 



The Defense Data Network, or 
ARPANET/MILNET 



Sending Mail to People on the 
Defense Data Network 



When you specify the mail address on the command line after mail, make sure 
to put a backslash character (\) before each occurrence of an exclamation point 
(oldf orest \ !bree\ ! lothlorien\ ! galadriel to modify the above 
example), so that the shell interprets the address properly . 21 

You can learn about aliasing a mail address to another character string in the 
mail Man Page, online or in the Commands Reference Manual. 



When people with accounts on a UUCP machine ask you how they can send mail 
to you, try to come up with the appropriate network path. Determine your user- 
name, your machine name, and other machines you know your machine talks to 
using UUCP . 22 Determine the other person’s username, machine name, and asso- 
ciated machines. Hopefully, you will discover an associated machine in com- 
mon, so that you can identify a network path between you. 

For more information on the UUCP network, see your system administrator, or 
look in System Administration for the Sun Workstation. 



The Defense Data Network, or ARPANET/MILNET is a network financed by the 
Advanced Research Projects Agency of the U.S. Department of Defense. Some 
of the work that travels across the MILNET portion of the ARPANET/MILNET net- 
work is classified information, so access to that portion of the network is con- 
trolled. 



To send mail to someone on the Defense Data Network, you must find out the 
username and machine name of the mail recipient, usually by asking the reci- 
pient. Unlike the UUCP network, however, you don’t need to know the names of 
all the machines between your’s and the recipient’s machine. The Defense Data 
Network takes care of that part automatically. 

Construct the mail address by typing the recipient’s username, followed by an 
at-sign character (@), the recipient’s machine name and the suffix . arpa. So, 
for Defense Data Network user space war on machine mars, the appropriate 
mail address is : 23 



spacewarQmars . arpa 

Type the mail address as an argument to mail on the command line, then com- 
pose and send the mail message as usual. 



21 The shell usually interprets exclamation points as part of the history mechanism. Putting a backslash 
before each exclamation point requires the shell to interpret the exclamation points as regular characters, rather 
than as special history mechanism characters. See the chapter on timesaving features in Getting Started With 
Unix: Beginner’s Guide for more information about the history mechanism. 

22 See the Man Page, online or in the Commands Reference Manual, for the uuname and uupath 
commands, if your site supports them. 

23 Soon, with changes in the Defense Data Network, you’ll have to find out users’ domains as well as their 
host names to send mail. Domains such as edu and com will replace arpa. 
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How Does Someone Send Mail 
to Me on the Defense Data 
Network? 



9.3. Summary 



Providing your username and machine name should be sufficient for someone on 
a Defense Data Network machine to send you mail. 24 

For more information on the Defense Data Network, see Using the Network: 
Beginner’s Guide, and the references to ARPANET/MILNET in the sendmail 
configuration guide, located in System Administration for the Sun Workstation. 



You’ve covered all of the basic material on electronic mail, electronic messages, 
associated commands, and mail over networks. For further reading, a command 
summary, and a glossary of terms, look in the appendices. 



24 Sometimes, the situation gets more complex. Contact your system administrator, or look in System 
Administration for the Sun Workstation. 
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Further Reading 



When you want to read more, start with these manuals: 

Games, Demos, and Other Pursuits: Beginner s Guide 
Doing More With UNIX: Beginner s Guide 
Using the Network: Beginner s Guide 

Commands Reference Manual 

System Administration for the Sun Workstation 
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Command Summary 



This is a summary of all commands mentioned in this manual. Each command 
appears in alphabetical order by name, and includes a syntax diagram, and a brief 
paragraph describing its function. 

The commands appear in one of four sections: mail commands, mailtool 
commands, message commands, other useful commands. Portions of commands 
that appear in bold are abbreviations for the command. 



B.l. mail Commands 



mail mail [ username ] 

mail - f filename / foldername 

Start the mail program to read mail from the system mailbox or 
the specified file or folder name or, with username , send mail to that 
user (end message text with [ CTRL-D ) ). 



To the Ampersand mail 
Prompt 



headers headers 

Display numbered mail message list 

message- number 

message-number 

Display mail message with that number. 

print print [ mess age- number ] 

Display current mail message, or message with specified number. 

quit quit 

Exit mail program. 

reply reply [ message-number ] 

Reply to current mail message, or specified mail message. 

save save [ message-number ] filename / foldername 

Save current mail message, or message with specified number, into 
specified filename or foldername. 

? ? 

For help information. 
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While Composing a Message 



B.2. mailtool Commands 
mailtool Options 



mailtool Buttons 



~m ~m [message-number] 

Insert a copy of the current mail message, or the specified message. 

~ r “ r filename / folder name 

Insert a copy of the specified file or folder. 

~V ~ V 

Enter vi text editor within mail. 

~? ~ ? 

For help information. 



The mailtool command uses the standard options of window and mouse pro- 
grams and: 

-i # check for new mail every # seconds (default 5 minutes) 

-x expert mode, don’t ask for confirmation of commands 



mailtool command panel buttons are: 

1 abort 1 

Quit the tool without modifying your system mailbox 

1 cdl 

Change to the directory specified in the Directory : text item 
1 cancel ) 

Abort the message you’re composing in the composition subwindow 
[ commit I 

Commit changes to your system mailbox 
( compose } 

Open the composition sub window to compose, or forward, a message 
( copy) 

Copy the selected message to the file or folder specified in the File : text 
item 

( deliver 1 

Send the message you’re composing in the composition sub window 
f delete 1 

Delete the selected message 
[ done J 

Commit changes and close the tool 
I folder ] 

Commit changes and switch to the file or folder specified in the File : 
text item 
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( new mall 1 

Commit changes and reread the system mailbox to see new mail 
l next J 

Show the next message in the message subwindow 
[ preserve 1 

Hold the selected message in the system mailbox after the next commit 
1 print] 

Print the selected message on a hardcopy printer 
[quit] 

Commit changes and quit the tool 
l reply! 

Open the composition subwindow to reply to the selected message 
( save 1 

Save the selected message in the file or folder specified in the File : text 
item 

( show 1 

Show the selected message in the message subwindow 
[undelete! 

Undelete the most recently deleted message(s) — can repeat use 
[ .mailrc 1 

Source your ~ / .mailrc file to acquire the current option settings 

In general, 1 SHlti 1 reverses the direction of a button command; 1 CTRL] 
strengthens the effect of the button command. 



B 3, Message Commands ^ , . ra , . n 

talk talk username [@ machine name] 

Start interactive message session with specified user on local net- 
work; if no yellow pages, specify machine name of user too. 

wall wall 

Send broadcast message to everyone on machine. Type message text 
starting on next line; end with ( CTRL-D 1 on a line by itself. 

write write username 

Send message to specified user. Type message text starting on next 
line; end with \ CTRL-D 1 on a line by itself. 

B.4. Other Useful Commands 

from from 

Display addresses of senders of mail messages waiting in your mail- 
box. 

prmail prmail 

Display mail messages waiting in your mailbox. 
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rsh 



users 

w 



who 



sun 

microsystems 



rsh machine-name command 

Perform specified command on specified machine, for use in finding 
out information about who’s logged in on other machines in your 
local network. 

users 

Display usernames of terminals running on your machine, 
w 

Display system information, including the current time, how long 
since last reboot of your machine, number of terminals running on 
the machine, and system load information. Then, display the user- 
name, the terminal name, the time of terminal login, other system 
information, and what program that process is running for each ter- 
minal running on your machine. 

who 

Display usernames, terminal names, and creation dates and times of 
terminals running on your machine. 
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This glossary lists mail and message terms in common use, especially in this 
manual. For commands, see the command summary, Appendix B . 

abort a mail message 

To decide not to send a mail message and to interrupt the mail sending pro- 
cess. 

broadcast message 

Message sent to all users on a machine 

button 

Either: 

□ One of the three buttons that you can press on a mouse. 

□ ‘ ‘Software” representations of buttons on a control panel within a win- 
dow and mouse program like ma i 1 1 o o 1 . 

click 

To press and release a mouse button. 

command panel 

With mailtool, a section of the window that presents the command but- 
tons so you can select them. 

compose 

Create a mail message using a text editor like vi, or the text window of 

mailtool. 

console 

A terminal, or a special window on the screen, where system messages 
appear. 

current message 

The mail message that you last read, or the first mail message that mail 
pulls from your system mailbox when obtaining new mail. 

electronic mail 

The same as mail. 

electronic messages 

The same as messages. 
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field 

One line in a mail message header that begins with a standard designator 
identifying its purpose. 

flag 

An indicator that looks like a flag on the mailtool icon that raises when 
you have new mail waiting in your mailbox. 

folder 

A special kind of file that you can use to store and organize your mail mes- 
sages. 

gateway 

A link between two networks, 
header 

The part of a mail message that contains the information that identifies the 
message and makes it possible to deliver the message. 

icon 

A small rectangular window on the screen that identifies a closed, or iconic, 
window and mouse program. 

interactive message 

A message that someone can read and respond to while you, the message 
sender, wait. 

local network 

A network of machines directly surrounding your machine that may attach 
through a gateway to remote networks. 

mail 

Electronic correspondence from one user to another on a computer network, 
mailbox 

A file that stores your mail until you are ready to read it. 
menu 

With some window and mouse programs, a selection of possible action 
choices presented in a rectangular box. You pick items with the mouse. 

menu item 

One of the possible choices on a menu. 

message header 

The same as header. 

message number 

The same as number. 

message status 

The same as status. 

message text 

The same as text. 
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messages 

Immediate and interactive electronic communication between users on a 
local computer network, not to be confused with a mail message. 

network 

A group of machines connected together so they can transmit information to 
one another. There are two kinds of networks: local networks and remote 
networks. 

network path 

A series of machine names used to direct mail from one user to another, 
new message 

A mail message that you have just pulled out of your system mailbox, 
number 

A mail message characteristic that allows you to choose that message, 
old message 

A message that you’ve already read. 

pipe 

Software connection between two programs. 

Postmaster 

The username designated to receive notice of messages that the mail facility 
cannot deliver. 

process 

The operating system software UNIX uses to execute commands. 

remote network 

A network that doesn’t include, at least directly, a specific machine, 
reply 

Respond to a message, 
ring a party 

Try to attract the recipient of a talk message’s attention by displaying 
messages on the recipient’s screen. 

select 

Choose, usually by pressing mouse buttons, 
shell script 

A series of commands run as a program by the shell, 
status 

New, old, or unread classification of a mail message, 
subwindow 

One of multiple windows within a window-based tool like mailtool. 
system message 

Messages that the system generates automatically to notify you about some- 
thing that may be important, such as new mail, message of the day, or login 
information. 
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terminal 

A process running on a machine that originates with the physical device 
called a terminal, or as a software representation of such a physical device, 
like a window. 



text 

The part of the mail message that contains the communication to the reci- 
pient, to be distinguished from the message header. 

trash bin 

A file in which mailtool stores deleted mail messages, 
unread message 

A mail message that you already pulled from your system mailbox, but have 
not yet read. 

window and mouse program 

A program that makes use of SunView, the window system and associated 
software, so that you can use the mouse to locate and select for items within 
the tool, all within a window on your screen. 

window-based tool 

The same as window and mouse program. 



yellow pages 

A directory of usernames and machine names on a local network that pro- 
vides automatic machine name addressing of mail messages. 
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